LECTURE NOTES 


. INTRODUCTION 

A. Welcome 

B. Names 

C. Schedule 

D. Handou+s 

E. Why develop Software for the Atari? 

1. better mach Ine; you can do more. 

2. ultlmately a blgger market (consumers) 

3. better support 


II. PCS SYSTEM OVERVIEW 

A. A very peopIe-orIented Computer 

B. Hardware 

1. 6502 (1.79 MHz) 

2. RAM (192K posslble) 

3. ROM (10K OS, 8K or 16K cartrldge) 

4. VIA 

5. POKEY sound, Controller ports, serial bus 

6. ANTIC dlsplay mlcroprocessor 

7. CTIA televlslon output 

C. Large memory map: 


OS RAM FMS DUP < 

- 1 - 1 - 1 - 

1.5K 5K 7K 


D. Strengths and weaknesses 

1. GRAPH ICSI 

2. sound 

3. Controllers •. 0 

4. 1.79 MHz 6502 .. 

5. operatlng System (screen edltlng) n? 

6. BASIC variable names, indirectfon, syntax error handling 

7. BASIC strlngs 

8. slow dlsk 

9. Ilttle page zero or absolute RAM available 

10. maximum of flve color regIsters In plaln BASIC 

11. dlfflcult to add hardware 


—————iiser area-> cartrldge hardware flrmware 

up to 32K 8K 6K 10K 



III. ANTIC AND THE DISPLAY LIST 

A. Background: how a TV works; deflnltlons of terms 

B. dlsplay System used by other personal Computers 

1. mlcroprocessoi—>RAM—>hardware~>screen 

2. the 'hardware' part 1s the IImitIng factor 

3. PET, TRS-80: flxed RAM, single mode (text). simple hardware 

4. Apple: two RAM slzes, 3 fundamental modes, better hardware 

C. The Atari dlsplay System 

1. functlonal differences 

a. 14 fundamental dlsplay modes 

b. modes changeable on screen 

c. screen RAM anywhere 

2. ANTIC, a Video mlcroprocessor 

3. ANTIC's Instruction set 

a. dlsplay Instructlons (graphtcs, text, or blank) 

b. JMP and JVB 

c. special optlons (scroll, DLI, and LMS) 

4. the dlsplay 11st (ANTIC'S program) 

a. synchronlzed to televlslon cycle 

5. screen memory 

6. ANTIC wrltes only to CTIA 

D. A sample dlsplay IIst (all values ln hex) 

70 Skip 8 I Ines 

70 sklp 8 IInes 

70 sklp 8 I Ines 

42 'mode 0' II ne wlth Load Memory Scan 

LO address of screen memory 

Hl address of screen memory 

xx here follow mode bytes 

xx must total 192 horizontal scan IInes 

xx 

XX 

XX 

XX 

XX 

XX 

XX 

41 Jump and walt for vertlcal blank... 

LO ...to beginn Ing of dlsplay 11 st 
Hl high byte of address of dlsplay IIst 

E. UsIng dlsplay IIsts 

1. make a paper Image 

2. mode II ne Setup 

3. scan 11 ne count 

4. arranglng screen memory 

a. mixed mode screen memory dlscontlnuItles 

b. malntalnlng Integer multiples 

c. brüte force: calculatlng addresses 

d. settlng up Independent Windows 
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F. Uses of display II st manipgIatIons 

1. vertlcal spaclng 

2. mixed modes (note probiems abovel) 

3. access to new modes 

4. screen sequencing 

5. dynamlc display llsts 


IV. INDIRECTION: COLOR REGISTERS AND CHARACTER SETS 

A. Indlrectlon Is harder to understand but more powerful 

B. Color reglster Indlrectlon 

1. One number In a color reglster Controls the color of many plxels 

2. less RAM consumptlon 

3. more colors to choose from 

4. color cycllng (anlmatlon) 

5. loglcally keylng colors to sltuatlons 

6. display IIst Interrupt capablIIty 

C. Character set Indlrectlon 

1. Direct: character Code gtves character In ROM 

2. Indlrect: character Code glves character In any speclfled table 

3. Procedure 

a. deflne characters on graph paper 

b. encode Into bytes 

c. stuff Into RAM 

d. POKE CHBAS wlth address of charset 

e. must Start on 1K boundary (1/2K for GR. 1 4 2 sets) 

f. 8 bytes per character 

4. CapabII111es 

a. multiple character sets (fonts) 

b. graphlcs character sets; maps; mixed text and graphlcs 

c. 4 color character sets 

d. vertlcal reflect 

e. time changes of character sets 

f. human slow: change of scenery 

g. human fast: anlmatlon 

h. mach Ine fast: DLl's 

5. Overall assessment 
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V. PLAYER-MISSILE GRAPHICS 

A. The problem: Animation 

B. The traditional solution: playfield animation 

1. move bytes through RAM to move screen tmage 

2. address calculations; very slow 

3. resultant limltatlons: 

a. pure horizontal motlon 

b. pure vertical motlon 

c. few objects moving 

d. slow motlon 

4. Essence of problem: 2d Image, Id RAM 

C. The Atari solution: player-missile graphics 

1. Fundamental Idea: Id Image, Id RAM 

2. map table of bytes directly from RAM onto screen 

3. Image Is a vertical column 8 bits wide 

4. vertical motlon with Id move routine 

5. horizontal motlon by horizontal positlon reglster 

D. EmbeIIIshments 

1. 4 players, each with Its own color reglster 

2. Control Iable player wldths 

3. Two vertical resolutions posslble 

4. missIIes (two blts wide) 

5. Image prlorlties 

E. How to do It 

1. Set aside player-missile RAM area (1K or 2K) 

2. set player colors 

3. set player wldths and positlons 

4. draw In players 

5. enable through PMBASE and DMACTL 

6. see demo program H0BBY1 

F. Capabllities 

1. Animated objects 

2. Additional color 

3. Special offline characters 

4. Cursors 

5. additional resolutlon by priority control 
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VI. DISPLAY LIST INTERRUPTS 


A. A very powerful capablllty 

B. Fundamental Ideas 

1. Screen drawlng Is time sequenced 

2. By cuttlng Into draw at approprtate time, Image can be changed 

3. change Image by changIng ANTIC regIsters 

4. Timing provlded by the DLI 

C. How a working DLI happens 

1. ANTIC encounters dlsplay 11st Instruction wlth Interrupt blt set 

2. ANTIC checks NMIEN for enabllng blt 

3. If DLI Is enabled, ANTIC Interrupts 6502 

4. 6502 vectors through $0200, $0201 to your DLI Service routlne 

5. When done, 6502 resumes work. 

6. Process repeats at same pofnt on screen each 1/60th second. 

D. How to set up a DLI 

1. Wrlte and place DLI Service routlne (page slx?) 

2. Set DLI blt In approprtate dlsplay IIst Instruction 

3. Set DLI vector In $0200, $0201 

4. Enable DLI wlth $C0 Into $D40E 

5. Sample program: H0BBY2 

E. Conslderatlons 

1. colors Into ANTIC, not shadow. Attract 

2. Executlon time 

3. thlngs happentng halfway across llne; (WSYNC); keyboard IRQ 

4. Multiple DU’s: Separation problem, slow response 

5. UsIng VCOUNT 

F. Capabllltles 

1. Multiple playfleld colors 

2. Multiple color, wldth, Position, and prlorlty players 

3. Multiple character sets; Rosetta Stone 

4. vertlcal screen archltecture 
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VII. SCROLLING 


A. Coarse scrolltng 

1. me+hod 1: move data through playfleld wlth move routlne. 

2. method 2: move playfleld over data wlth LMS byte changes. 

a. serial scroll wlth single LMS Instruction 

b. pure vertlcal scroll wlth single LMS Instruction 

c. pure horizontal scroll wlth multiple LMS Instructlons 

d. mlxlng horizontal scroll wlth vertlcal scroll 

B. Fine scrolI Ing 

1. scrolIs ent Ire plxel llne 

2. elther horizontal or vertlcal or both 

3. 11ne by llne controI 

4. DLI capablllty 

C. How to do It 

1. set scroll blt In dlsplay JIst Instruction 

2. störe HSCROLL and VSCROLL values 

3. edge buffer Ing 

4. coupllng wlth coarse scrolltng 

5. sample program: SCRL19.ASM 

D. Applications 

1. Large Images wlth screen wlndow 

a. maps 

b. dlagrams (schematlcs, blueprlnts) 

c. large blocks of text 

d. menus 

e. screen rotatlons (well, almost) 
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BASIC OUTLINE 


I. PRIMARY CODING GOALS 

A. Speeding Up BASIC 

B. Saving Memory 

C. BASIC Bugs 

II. HOW ATARI BASIC WORKS 

A. The Token File Structure 

1. Token Output Buffer 

2. Variable Name Table 

3. Variable Value Table 

4. Tokenized Program 

5. Immediate Mode Line * 

6. String Array Area 

7. Run Time Stack 

B. LOAD and SAVE BASIC Files 

1. Format Of SAVEd Disk File 

2. How The Pointers Are Used 

III. ADVANCED PROGRAMMING TECHNIQUES 

A. Special Features Of BASIC And The OS 

B. Example Programs 

1. Initialize A String 

2. Delete Lines Of Code 

3. Modify String/Array Pointers 

4. Save And Retrieve BCD Numbers On Disk 


5. Name Table Modifier 







SINGLE LINE QF TOKEN PROGRAM 


/ 


LABEL 

HEX / | 

LOMEM 

80,81-/ 

VNTP 

82,33^ I 

VNTD 

_^ 

84, 85—T 

VVTP 

86 t 87^ I 


11 

STMTAB 

88,39—-" | 

STMCUR 

SA,8B—«. i 

'i 

STARP 

8C, 8D-\. 1 

N I 

RUNSTK 

8E,8F-s^ N 

MEMTOP 

90,91-^^ I 

- 

\ ^ 

— 

\ 1 


TOKEN 

OUTPUT 

BUFFER 


S 


VARIABLE 

NAME 

TABLE 




VARIABLE 
VALUE 
TABLE . 


TOKEN 

PROGRAM 


y 




IMMED 

LINE 


STRING 

ARRAY 

AREA 


RUN TIME 
STACK 


/ 


/ STilZEI VARIABLES ARE X,Y*,AND ZO 


/■- 

/ 8 BYTES PER ENTRY 


/ 



1 11 

2 | 

3 4 | 5 

6 1 

7 8 | 


1—+ 

-+ 


-+ 

-1 

SCALAR 

1 00| 

1 t 

VAR* | 

1 

VAR* | 

C6 BYTE BCD 

1 

CONSTANT3 | 

t 1 

ARRAY 

1 1 
I4Ü| 

1 

CDISPL3|CDIM 

i 

131 

i 

CDIM 2I| 

(DIM) 

1411 

1 

i 

1 

1 

STRING 

1801 

VAR* | 

CDISPLI|CLENGT3| 

CDIM 3 | 

(DIM > 

I81| 

1 

1 

1 









SEE BELOW 




ARRAY 6 BYTE BCD NUMBER PER ENTRY 
STRING 1 BYTE ATASCII PER ENTRY 




\ 


\ 


GOSUB 


FOR/ 

NEXT 


4 BYTES PER ENTRY 

0 ,LINE*C2B3,SAVDEX—1 

16 BYTES PER ENTRY 

LIMITC6-BCD3,STEPC6-BCD3 
VAR*,LINE* C2B3, SAVDEX-1 


EXAMPLE PROGRAM 


10 REM TOKENS 

20 FOR X=PEEK (130) +PEEK(131 > *|Z56 TO PEEK <IAO ) +PEEK(141 > *256-1 
30 PRINT PEEK(X);" "HNEXT X 


EXAMPLE OUTPUT (PARTIALLY FORMATTED FOR READING) 
RUN 


(VNT ) 

216 

<IZI) 







(VND) 

0 

(DUMMY) 






(VVT ) 

0 

0 

65 

118 

51 

0 

0 

0 

(STM) 

10 

0 

12 

12 

0 

84 

79 

75 


20 

0 

75 

75 

8 

128 

45 

70 




70 

58 

14 

65 

1 

49 




0 

0 

25 

70 

58 

14 




14 

65 

1 

65 

0 

0 




38 

14 

64 

1 

0 

0 


30 

0 

19 

15 

32 

70 

58 

128 

, 



22 






(IMM) 

0 

128 

6 

6 

37 

22 




69 

78 

83 

155 

(ATASCII) 





58 

14 

65 

1 

48 

0 

0 

0 

44 

37 

0 

0 

0 

44 

36 

14 

65 

2 

86 

0 

65 

1 

64 

0 

0 

0 

44 

37 

70 

58 

0 

44 

36 

14 

65 

2 

86 

0 

0 

0 

0 

0 

22 








44 

21 

15 

1 

32 

21 

20 

19 

9 

128 


NOTE 


BOXED CHARAC-TERS APPEAR AS INVERSE VIDEO ON THE SCREEN 























BASIC BUG LIST 


:L) An IN PUT stabe Ment with no variable is not flayqed as an error. 

2) PRINT A-N.OT B er a sh es the systen* 

3) DIM L (10) is treated as DIM L10). 

T) LÜG( ü ) .CLOG(0) f LOG(1).CLOG(1) qi ve incorrect va1ues♦ 

*» 

5) PRINT “ö qives a nesningless nuwber. 

6) L ine edi ti ng 1 csekup and incorrect hand 1 inq of 256 byte str inqs . 

7) A nuneric srray of 3 2766 by 32766 e1enents can be dinensioned. 

8) A R E S T 0 R E c o m m a n d d o e s n o t q e n e r a t e a ri e r r o r 12 i f t h e r e s t o r e d 
1 i n e n u m b e r d o e s not e ist* 

9) Integer exponents of integer values do not qive correct results* 

10) An input frort disk of 256 bytes will overwrite the first 128 
b y t es of paq e six in RAH. 

11) A PRINTed GTL R or CTL U is treated as a seMicolon. 



22-141 SO SHEETS 
22-142 100 SHEETS 

22-144 200 SHEETS 






OPERATING SYSTEM OUTLINE 


1) SysteM Routines (No direct user access) 


Monitor 

Handies Power-Up and RESET Button 
Boots in application Software 
Has its own "MeMO Pad" 

2) SysteM Tables (ROM and RAM) 

System Utility Vectors 

Starting addresses of various OS Utilities 


SysteM Database 

Pointers and variables used by the systeM 

Hardware Shadow Registers 

Allows Updates to occur during VBLANK 


Character Set 

The 128 ATASCII eharaeters 


Various ROM Tables 

Keyboard to ATASCII translation 
Screen Händler tables 
Additional tables 

3) User Callable SysteM Utilities (Direct user access) 

I/O Subsyste« 

Central I/O Utility (CIO) 

Device Händlers N 

Serial I/O Händler (SIO) 

Interrupt Händlers 
NMI 
IRQ 

Floating Point Routines 

Six byte BCD fornat used 

Software TiMer Routines 

Allow tiwing of 1/60 second resolution 
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ATARI UTILITIES DISKETTE 


This Utilities dtskette ts dlstrlbuted to outsIde Software developers to 
fac111täte thelr efforts. This Software Is not In the public domatn and Is 
not to be dlstrlbuted. The Utilities In this package are: 


DOS 

SYS 039 

DUP 

SYS 042 

BUILD24 

010 

DIV 

SRC 026 

BMUL 

SRC 020 

SMUL 

SRC 027 

CHRGEN 

049 

SOUND 

095 

XREF 

052 

MASHER 

045 

RENUM 

BAS 030 

FORMTR 

004 

M8TXT 

005 

BCDSAV 

004 

HOBBY1 

008 

H0BBY2 

005 

SCRL19 

ASM 104 

SCRL19 

OBJ 011 

FIX 

OBJ 042 

SCRLH 

DEM 004 

MDIR 

OBJ 002 

H0RSE20 

BAS 047 

AUTÖRUN 

SYS 001 

MDL 102 

BAS 005 

DEM03 

B0K 005 

DEM04 

BOK 004 

DL 1 STA 

DEM 005 

SCRLF 

DEM 003 

SCRLV 

DEM 004 


DOS 2.OS 
DOS 2.OS 

bullds self-boottng BASIC programs 
an Integer dlvide utillty 
a slgned Integer multlply routtne 
unslgned Integer multlply routtne 
a simple character set edttor 
a sound edltor 

cross-reference program for BASIC 

compresses BASIC programs 

renumbers BASIC programs 

formats LIST flies from ASSEMBLER 

BASIC mode 8 character prlnt routlne 

makes ffxed-length number records 

simple player-mlsslle graphlcs demo 

simple dlsplay IIst Interrupt demo 

full fine scrolI Ing module 

object code 

a dIsk sector utIIIty 

simple horizontal scrolI demo 

glves dlsk dlrectorles from BASIC 

a character set anlmatlon demo 

the R: devlce handler 

multiple dlsplay I Ist Interrupt demo 

player prlorlty trlck 

player as special character demo 

alternatlng dlsplay II st demo 

simple fine scrolI demo 

simple vertlcal scrolI demo 


None of these programs are flnlshed products; they all contaln rough 
spots. If you make Improvements please send a copy to our llbrary. 
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CHARACTER EDITOR 


Thls program Is a character edltor that makes It easler to take 
advan+age of +he redeflnable character set capablllty of the Atari. It glves 
you the capablllty to edlt, load, or save character sets. 

The first menu Option Is to create or edlt a character set. If you enter 
thls option without first loadlng a character set, It will default to a blank 
character set. You edit characters wlth the joystick, selecttng a plxel 
Position with the stick and the Status of that plxel (on or off) wlth the 
button. When you are done editing a character, you can allocate it to a 
character position wlth a keystroke indication. Fear not, most operations are 
prompted, so that you can pick your way through the program rather well. The 
only blooper is that the prompt for an I/O Operation to the dlsk requires 
that you glve the Dis preftx. 

Thls program is usable but not at all as practical as IRIDIS's FONTEDIT 
program. I strongly urge you to buy and study the IRIDIS program if you want 
to do any character set work. If only it had a display list Interrupt.... 


SOUND EDITOR 

The sound edltor helps you develop new sounds. It is not approprlate for 
developing tunes or Jingles, or any long sound. It Is designed for developlng 
short sounds (1 second long) such as clangs, croaks, rattles, and other such 
nonsense. It only edits two of the four sound Channels. 

The program needs very little externaI documentatlon, as its title page 
describes the commands. The Joystick response Is slow, but you can use the 
'fast' command to speed It up and then use the normal speed to fine tune your 
sound. You should read the hardware manual to get an Idea of what the sound 
regIsters do. 

Don’t overlook the possibiIities thls program opens up. I have heard 
some very convinclng sound effects created wlth It; it just takes a little 
I mag i nat I on. 
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CROSS REFERENCE UTILITY 


This utlllty provldes a cross-reference of variables and constants In a 
BASIC program. It requlres at least 40K of RAM, a prlnter, and a dlsk. The 
BASIC program to be cross-referenced should be on a dlskette In SAVE format. 
The program first glves a count of the total number of variables used. For 
each variable, It lists all llne numbers contalnlng references to the 
variable. It also glves a count of how many tlmes each constant Is used. If 
an error occurs durlng prlnter output, you may recover by typtng GOTO 3050. 


RENUMBER 

This program will renumber your BASIC program on dlsk. The target 
program must be on the dlskette In LIST format. The program prompts you for 
the values It needs. The ’lnput devlce' will normal ly be Dsprogname. The 
'output devlce' will normal ly be D:newname. The 'starflng number' Is the new 
startlng llne number. 'From' and 'to' are the beglnnlng and endlng llne 
numbers of the sectlon of code you want renumbered. 


FORMATTER 

This program will format the output of your Assembler/Editor cartrldge 
so that you can get a IIst flle that looks good out of your Atari 825 
prlnter. Make the first Instruction of your assembly code a .OPT NOEJECT. 

Then assemble the IIst flle to the dlskette. Then drop Into BASIC and run 
this program. Respond to the name prompt wlth D:progname. This program Is 
deslgned for use wlth the Atari 825 prlnter, so good luck wlth anythlng eise. 
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MAPSCROLL 


Mapscroll is a demonstration program module that shows one way to use 
ffne scrolUng effectlvely. It creates a large map in BASIC’s graphlcs 2 mode 
uslng a redeflned character set. The map Is 32x64 plxels In size, but only 
10x20 plxels are displayed on the screen at any one time. The user can scroll 
the screen window across the map wIth the Joystick. The program was wrltten 
for easy Integration Into other packages. 

Scrolling is achieved by coupllng fine scrollIng through the hardware 
fine scrolling regIsters with character scrollIng by modlfying the LMS bytes 
In the display list. The fine scrolling Is straightforward; the character 
scrolling Is somewhat more intrlcate. Each display byte ln the display IIst 
has Its LMS blt set. The followlng two bytes glve the address of the display 
data. When the fine scrolling reglster overflows In the scrolling routlne, 
the routlne adjusts the bytes In the LMS addresses to poInt to the next 
character bytes. This adjustment is kept track of through a variable referred 
to as the offset. 

The other trlck in the program Is the redeflnition of the character set 
Into a graphlcs character set. The technlque Is very powerful; very few of 
the available characters In the character set are used and yet the resultlng 
map Is very believable. The map could be made even more realistlc by using 
the other characters. By changIng the character set at appropriate tlmes the 
program could produce a varlety of effects. 

The amount of System resource used Is low. The module as wrltten 
occupIes 4K of RAM. This includes the map, the display list, the 
Initializatlon routines, and the Interrupt Service routlne that reads the 
joystlck. Outside of this the program uses 4 bytes of page zero (two of whlch 
are available after InitialIzation Is complete) and seven bytes of page slx. 
The Interrupt Service routlne Is very fast so it will not slgnifleantly slow 
whatever maln program you plug It Into. Space has been left Inside the 4K 
block for addltlons and modIfIcatlons. The program Is not fully relocatable 
as there are four patches that must be made to relocate it; however, these 
patches are welI documented and easy to do. 

The easlest way to see this program In action Is to BINARY LOAD It from 
DOS. The ftle name Is SCRL19.0BJ. Then call It from BASIC wlth A=USR(27648). 
Plug a Joystick Into port 1 and scroll. At present the program does not 
Interface well with BASIC; I have found that BASIC's Cursor posltlonlng gets 
lost. This reflects more on my lazlness than on the program's tractabllity. 
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CARE AND FEEDING QF "HASHER" 


MASHER is a utility program writen in BASIC which compreses other 
BASIC programs. Since it is intended for internal use only, there are 
a few ''Features' 1 which the user should be au/are of. 

1) All files are in LIST formst. 

2) Do not use lines 0-9 in the source program. HASHER will use these lines 
for it*s own variable definitions. 

3) Do not use the variables Q0 - Q999. HASHER uses these for constants. 

4) Do not branch to REHark statements. Besides being bad pratice, MASHER 

has problems sometimes with this. 

5) Ther. U presently . bug .ith DAT» Statements. The* are packrf like any 
other Statement. You »111 nesd to unpack these öfter MASHwg. This bug 
will be fixed (someday). 

WHAT IT DOES 

MASHER will perform the following conversions on the source program 

1) Removes all REMarka 

2) Converts frequently used constanta to variables. 

3) Packs small lines together to form long lines. 

NOTES 

This program will usually save between 55 - 405. Maximum compression occures 
when short lines are used in the source program. You must know the number 
of variables used in the source program. This can be obtained by running .5YH8ÖL. ■ 


PMMOVE 


This program uses a machine language routine to move Players and Missiles. 
The routine is called by: 

USR(ADR(MOVE $),PMNUMB,XPOS,YPOS) 

PMNUMB refers to the Player (0-3) or Missile (4-7) to move. The Missile 
number is determined by PMNUMB-4. XPOS and YPOS are the X and Y Coordinates 
to place PM. A Relocator is used to make the PM Move routine wherever it 
may be placed in RAM by BASIC. 


BINARY ROUTINE 


This routine is included as' part of the PMMOVE routine. BINARY loads or 
saves a binary file from BASIC. 


On entry 


CMD=7 

CM0=11 

STADR= 

BYTESs 

I0CB= 

FILE$= 


means load a file 
means save a file 

the address to load or save a file from 
the number of bytes to save or load 
the 10CB to use 
file name to load 


On exit ERR0R=1 means successful load 

ERROROI means it's an error Status 


BMUL 


This routine implements BOOTHS ALG0RITW1 for multiplication of SIGNED 
binary numbers in TWO's-COMPLEMENT notation. 

The MULTIPLIER is shifted to the right with the PRODUCT (as usual). Each 
CHANGE of the MULTIPLIER bits from zero to one causes the KftJLTIPLICAND to 
be subtracted from the PRODUCT. Each change from one to zero causes it to 
be added. 

Like most signed arithmetic, it cannot be chained and is prone to overflow 
Problems when given -32768, but it is smaller than the absolute-kludge 
wrapped around an unsigned mutiply, and not much slower (633-945 cycles). 

Enter with A,Y = MULTIPLIER (A=MSB) 

ACC = MULTIPLICAND 

16 * 16 SIGNED MULTIPLY 

Exit with ACC,MQ = 32 BIT PRODUCT 
ACC = MSW 
MQ = LSW 

ACC =212 
• MQ = $0CB 
ENT = $0CD 
SC = $0CF 
* = $600 


DIV 


This routine is composed of two assembly subroutines: Unsigned Divide of 
32/16 bits and Signed Divide of 16/16 bits. 


Unsigned Divide: 


Enter with A,Y 
ACC,MQ 


Divisor (A=MSB) 
Dividend 


Exit with ACC = Remainder 
MQ = Quotient 

Signed Divide: 

Enter with A,Y = Divisor (A=MSB) 
ACC = Dividend 

Exit with ACC = Remainder 
MQ = Quotient 


SMUL 


This routine is composed of a 16 * 16 Unsigned Multiply and a 16 * 16 
Signed Multiply. ' 

Unsigned Multiply: 

Enter with A,Y = MULTIPLIER 

ENT = MULTIPLICAND 
ACC s ADDEND 

(ACC,MQ) = ([A,Y]*ENT)+ACC 
(This way for chained operaton) 

556-748 Cycles 

Signed Multiply: 

Enter with A,Y = MULTIPLIER (A=MSB) 

ACC = MULTIPLICAND 

Exit with ACC.MQ = PRODUCT 
ACC = MSW 


584-821 Cycles 


M8TXT 


M8TXT demons+rates how to mix +ex+ with graphics in BASIC mode 8. It 
plo+s the characters bit by bit onto the mode 8 screen. The technique can be 
adapted to any program using BASIC mode 8 displays. 


BCDSAV 

This program provides an alternative to the vartable length records 
obtained when a program PRINTs values to the dtsk. llslng the variable table 
values, It stores BCD values of numbers to the disk In fixed length records. 


HOBBY1 

This Is a simple player-mlssile graphics demo. It sets up a player and 
then moves It around with the Joystick. Since this Is a pure BASIC program, 
the vertical motlon of the player is too slow. An assembly language routine 
Is necessary to get proper high-speed motlon. 


H0BBY2 

This Is a simple display list Interrupt demo program. The bottom half 
of the screen changes from blue to pink. 


BUILD24 

This program creates an AUTORUN.SYS ftle that will start up your BASIC 
programs. It asks you for a BASIC command; the command you enter will be In 
the AUTORUN.SYS file and will be executed on powerup. Normal ly your command 
will be of the form RUN"D:PROG.BAS". It must be less than 128 characters 
long. Remember to put In the terminating double quotation mark (”). 


MDI R 

This program is an object file that can be calied from BASIC to put the 
disk directory onto the screen. To use It, you must first load it into RAM 
with the BINARY LOAD command (L) in the DOS. Call it from BASIC with 
A=USR(1536). 


AUTORUN.SYS 

This program is an RS-232 handler file. It allows you to use the R: 
device. It is booted in automatically on powerup. 
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H0RSE20.BAS 


Thls Is the runnlng horse demo. It demonstrates the power of character set 
graphlcs and anima+Ion. 


SCRLH.DEM 

Thls Is a simple horizontal coarse scroll demo. 

SCRLV.DEM 

Thls Is a simple ver+ical coarse scroll demo. 


SCRLF.DEM 


Thls Is a simple fine scroll demo. 


MDL 102.BAS 

Thls Is a multiple dlsplay 11 st Interrupt demo. It puts gobs of color onto 
the screen. Do not be alarmed If the screen goes black; It takes several 
mlnutes to flnlsh. Once It Is runnlng observe how keypresses affect the 
dlsplay. Also note the greatly reduced computatlon speed of BASIC. Wlth so 
many Interrupts happenlng, the 6502 has llttle time for other actlvltles. 


DEM03.B0K 

Thls program demonstrates a technlque for Increaslng the resolutIon of a 
stattonary player by hldlng It behlnd a playfleld cutout. 


DEM04.BAS 

Thls program shows how a player can be used as an extended character. 


DU STA.DEM 

Thls program demonstrates the alternatlng dlsplay 11st technlque. 
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